Skip to main content

SCIM User Provisioning

Cost New supports the provisioning of users through a SCIM (System for Cross-domain Identity Management) API.

This means that the information for users assigned to the app in an identity provider can be pushed to Cost New before they ever log in. This is useful for permission assignment when adding new users because it doesn't require any action on their part.

Required Information

Configuring provisioning will require a Scim API token and your tenant SCIM API endpoint for Cost New.

The endpoint will be https://<tenant name>.agcostnew.com/<tenant name>/scim where <tenant name> is the name of your tenant (e.g. https://example.agcostnew.com/example/scim).

To obtain the appropriate token contact AgWare support.

Cost New does not require any configuration to enable provisioning. All configuration will occur on the identity provider and can vary depending on the identity provider.

Supported Operations

Cost New supports the following user operations.

  • Create
  • Update
  • Search
info

Not all identity providers show search in the settings, but it is listed in the SCIM spec as an operation.

Entra Configuration

Start by navigating to the Enterprise Application for Cost New.

Once in the Enterprise Application navigate to ManageProvisioning.

Entra enterprise app provisioning link

In the provisioning overview, click Get Started.

Entra provisioning overview

Then select the Automatic provisioning mode.

Entra provisioning modes drop down

Expand the Admin Credentials accordion menu and enter the Cost New SCIM endpoint URL in the Tenant URL field, and the SCIM API token in the secret token field.

Entra provisioning credentials

Once the fields are set click Test Connection. You should get a notification saying the test worked.

Entra provisioning test connection success notification

With the connection successfully tested, click Save to save the credentials.

Entra provisioning credentials

Now, navigate back to the provisioning overview and select Start provisioning to start the process. On Entra this will be run every 40 minutes.

Entra start provisioning button on the overview